home *** CD-ROM | disk | FTP | other *** search
/ Future Workshop / Future Workshop.iso / internet / rose / base.1 / BUGTIPS.TXT < prev    next >
Encoding:
Text File  |  1995-06-02  |  3.9 KB  |  84 lines
  1. Rosebud
  2. Tips on reporting problems 
  3. Date: 30May95
  4.  
  5. To help the developers fix the problems you are having it is most 
  6. helpful to have as much relavent information as possible.  This 
  7. information includes things like the exact steps you took that led to 
  8. the problem occuring, and debug logs.  Unfortunanity, most of these 
  9. items are not very useful unless the problem can be reproduced reliably.
  10.  
  11. Also all of these files probably are not needed in all cases.  So, try 
  12. and use some common sense in trying to decide which of these files would 
  13. probaly be needed to track down your problem.
  14.  
  15. It is also useful to try and describe all steps that you took that led 
  16. up to the problem.  Try and think of what you did that was different 
  17. than what one normally does in performing whatever you were tying to do.  
  18. For example, donÆt describe a problem as ôI added a financial reporter 
  19. and it GPFÆedö  This does not provide any useful information.  Instead 
  20. describe the problem like: ôThe Viewer GPFÆed after I did the following:
  21.     1. Clicked on the Financial icon.
  22.     2. Clicked the Add button
  23.     3. Added 122 stock symbols to collect
  24.     4. Added retrieval times:
  25.             every 30 minutes MoTuWeThFe from 9:00am to 4:30pm
  26.             7:30pm on MoTuWeThFe
  27.     5. Clicked on OK and got GPF in CMPSRVCF.DLL at 0004:93D3
  28.  
  29. All bug reports should be emailed to æ>MHS: support@mageeÆ (this is in 
  30. the Rosebud address book) with any of the following files included as 
  31. attachments.
  32.  
  33. Below are some other files that can be very helpful.  If any of the 
  34. following files are relavent, please include them (zipped into 1 file if 
  35. at all possible) as an attachment in the bug report email message.
  36.  
  37. Dr Watson Logs
  38. Dr Watson is an application that comes with Windows that allows you to 
  39. get detailed information from an application that has a General 
  40. Protection Fault (GPF).  The tricky part is that this program 
  41. (DRWATSON.EXE) must be running when the GPF occurs for it to be able to 
  42. provide any information on the state of the system at the time of the 
  43. GPF.
  44.  
  45. So, if you are having a problem that occurs every time or very 
  46. frequently, you should start Dr Watson before you start the problematic 
  47. program.  Then after the program GPFs, a log file will be placed in the 
  48. Windows directory called DRWATSON.LOG that will contain information that 
  49. is very useful in tracking down what was going on when the program died.
  50.  
  51. DEBUG.LOG
  52. Rosebud has the capability of generating a detailed log file of 
  53. everything it does.  To enable this logging capability edit the file 
  54. DEBUG.SET.  The first line should look like æ#%debug.logÆ  to enable 
  55. logging simply remove the æ#Æ.  Now all activity is reported to this log 
  56. file.  This is not enabled by default because it degrades performance a 
  57. fair amount.  So, you will want to turn it on to run the programs in 
  58. question just once (to get to the error) and then turn it off again (by 
  59. adding back the æ#Æ).
  60.  
  61. RUN.LOG
  62. Rosebud has various levels of logging that can be used during the 
  63. collection of information.  This logging is written to the file RUN.LOG.  
  64. If you are having a problem in the Collection Agent you will want to set 
  65. the logging level to Log All (in the Assignment Desk æOptionsÆ button or 
  66. through the æLog OptionsÆ item in the File menu in Collect).
  67.  
  68. COMMPORT.LOG
  69. If you are having a problem in the Collection Agent and it appears to be 
  70. related to a communications issue, it is VERY helpful to have a copy of 
  71. the COMMPORT.LOG.  This file contains everything the Collection Agent 
  72. sent to CompuServe and everything CompuServe sent back.
  73.  
  74. To enable communications logging edit the WA.INI file and in the 
  75. [CompuServe] section change the line that reads æLogComms=0Æ to 
  76. æLogComms=1Æ.
  77.  
  78. MSD report
  79. If you at all think the error may be happening because of a 
  80. configuration problem, please include a copy of the report generated by 
  81. ôMSD.EXE /p MSD.RPTö.  This will give a detailed description of your 
  82. computer.
  83.  
  84.